home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / visulztn / saoimage / saoimage.lha / btnlib / readme < prev    next >
Text File  |  1989-11-09  |  2KB  |  40 lines
  1.  
  2. ButtonBox
  3.  
  4. This is a simple Button Panel widget.  Notable features are:
  5.  
  6. A) The buttons have four visible states (occupied-by-pointer/not-occupied
  7.    combined with on/off).
  8. B) Buttons can be given different functions (one-shot, radio-buttons,
  9.    toggle buttons, help-about-this-button, etc).  One button may have
  10.    several different response functions (within logic) depending on
  11.    the pointer button and event state.  The conditions under which a
  12.    button selection occurs are application selectable with button and
  13.    state masks for each response.
  14. C) Buttons can interact with each other in different ways (radio button being
  15.    an obvius example).
  16. D) Buttons can have submenus of buttons which appear when the parent button
  17.    is selected (similar to 'pull-down-menus' in function but different in
  18.    that they appear in an existing window, and remain until replaced).
  19.    Submenus can be cascaded (submenus of submenu buttons, ...).
  20. E) All calls are Xlib calls.  The design minimizes server interactions for
  21.    efficient operation, even over a network.
  22. F) Buttons are pre-processed with data structures largely filled at compile
  23.    time to reduce start-up time and eliminate any reliance on server font
  24.    resources at run-time.  (The pre-processor is in the tool sub-directory).
  25.    (My preferred font is X10's helv12 which is different from that provided
  26.    with X11 - both X10 and X11 pre-processing is available).
  27. G) The button appearance is specifiable (copied from a sample bit-map of its
  28.    border pattern).  It can be made runtime selectable to match the user's
  29.    preferred "look-and-feel".
  30. H) Buttons are run-time sized (and resized) to fit their windows.  When the
  31.    text label must be clipped to fit a small button, characters are dropped
  32.    and the remaining text is centered.
  33. I) Text labels can be rotated in the pre-processor, allowing vertical
  34.    text labels.
  35. J) The interface can accept UNIX socket masks to return on non-X11
  36.    UNIX select signals.
  37.  
  38.  
  39. The organization of the code is outlined in ROADMAP.
  40.